Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRSetImagingProperty

You can use the QTVRSetImagingProperty function to set the value of an imaging property of a movie.

OSErr QTVRSetImagingProperty (
                     QTVRInstanceqtvr,
                     QTVRImagingModeimagingMode,
                     UInt32imagingProperty,
                     SInt32propertyValue);
qtvr
An instance of a QuickTime VR movie.
imagingMode
An imaging mode. See "Imaging Modes" for a description of the available imaging modes.
imagingProperty
An imaging property. See "Imaging Property Types" for a description of the available imaging properties.
propertyValue
The desired value for the specified imaging property for the specified mode.
function result
A result code.

DESCRIPTION

The QTVRSetImagingProperty function sets the value of the imaging property specified by the imagingProperty parameter for the imaging mode specified by the imagingMode parameter and the QuickTime VR movie specified by the qtvr parameter to the value passed in the propertyValue parameter.

Note that default values for all imaging properties can be contained in a QuickTime VR movie file. If no defaults are specified in a movie file, the QuickTime VR Manager uses these values: for static mode, the kQTVRImagingQuality property is codecMaxQuality and kQTVRImagingDirectDraw is true ; for motion mode, the kQTVRImagingQuality property is codecMinQuality and kQTVRImagingDirectDraw is true . The default correction mode is kQTVRFullCorrection for both static and motion imaging modes.

It would look strange to have one correction mode for static imaging and a different correction mode for motion imaging. As a result, you should typically set the imagingMode parameter to kQTVRAllModes when setting a property of type kQTVRImagingCorrection .

SPECIAL CONSIDERATIONS

QTVRSetImagingProperty is valid only for panoramic nodes.

SEE ALSO

Use QTVRGetImagingProperty [link] to get an imaging property.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |